vcKinematicFrame

A Kinematic frame can be a base, tool or a system frame used in kinematics.

See in: Overview

Module: vcRobotics2

Parent: vcObject

Children -

Referenced by: vcFrameTarget.Reference, vcKinematics.ActiveBase, vcKinematics.ActiveTool, vcKinematics.FlangeFrame, ... (see more)
vcFrameTarget.Reference
vcKinematics.ActiveBase
vcKinematics.ActiveTool
vcKinematics.FlangeFrame
vcKinematics.RootFrame
vcKinematics.WorldFrame
vcKinematics.createBase()
vcKinematics.createTool()
vcKinematics.findBase()
vcKinematics.findTool()
vcLinearMotionStatement.Base
vcLinearMotionStatement.Tool
vcPtpMotionStatement.Base
vcPtpMotionStatement.Tool
vcSetBaseStatement.Base
vcSetToolStatement.Tool

Properties

Learn how to use properties here. The properties are also inherited from the parent class.

NameTypeAccessDescription
NameStringRWGets or sets the name of the frame. Name must be unique within the container the frame belongs to.
PositionMatrixvcMatrixRWGets or sets the transformation in reference (parent). Changes made during simulation are temporary and reverted upon sim reset.
WorldPositionMatrixvcMatrixRGets the transformation in simulation World.

Methods

Learn how to use methods here. The methods are also inherited from the parent class.

NameReturn TypeParametersDescription
deleteNoneNone"
Deletes the frame.

Parameters:
None

Returns:
None
getParenttupleNone"
Gets the current parent of the frame.
See more
Parameters:
None

Returns:
tuple[vcNode | vcKinematicFrame, vcKinematicFrameParentType]: Node or Kinematic frame and the appropriate type.
setConstantCircularVelocityTargetNonevcVector centerPoint,
vcVector rotationAxis,
Real velocity,
Real pitch
"
Starts interpolation of the frame with a constant angular velocity about the given rotational axis and center point.
The frame's current position is its starting position that determines the radius, and thus tangential velocity.
See more
Parameters:
centerPoint (vcVector): The center point of rotation relative to the frame's parent.
rotationAxis (vcVector): The rotation axis.
velocity (float): The velocity magnitude [degrees/s].
pitch (float): Rise or fall [mm/rev].

Returns:
None
setConstantVelocityTargetNonevcVector velocity"
Starts interpolation of the frame with a constant velocity from the current position to the direction of the vector.
See more
The speed/magnitude is the length of the vector. The velocity is given relative to the kinematic frame's parent.

Parameters:
velocity (vcVector): The velocity direction and magnitude [mm/s].

Returns:
None
setParentNonevcNode parent"
Sets the current parent of the frame. The value change is permanent e.g. is not reverted upon sim reset.
See more
Parameters:
parent (vcNode): New parent for the frame.

Returns:
None

Exceptions:
RuntimeError: When assigned parent is invalid.
setParentNonevcKinematicFrame parent"
Sets the current parent of the frame. The value change is permanent e.g. is not reverted upon sim reset.
See more
Parameters:
parent (vcKinematicFrame): New parent for the frame.

Returns:
None

Exceptions:
RuntimeError: When assigned parent is invalid.
stopMovementNoneNone"
Ends any active velocity command and stops the movement immediately.

Parameters:
None

Returns:
None